'\" t
.\"     Title: gogui-thumbnailer
.\"    Author: [FIXME: author] [see http://docbook.sf.net/el/author]
.\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
.\"      Date: 03/25/2011
.\"    Manual: GoGui Reference
.\"    Source: GoGui 1.3.0
.\"  Language: English
.\"
.TH "GOGUI\-THUMBNAILER" "1" "03/25/2011" "GoGui 1\&.3\&.0" "GoGui Reference"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
gogui-thumbnailer \- Create thumbnails for Go game files in SGF or Jago XML format\&.
.SH "SYNOPSIS"
.HP \w'\fBgogui\-thumbnailer\fR\ 'u
\fBgogui\-thumbnailer\fR [\fB\-config\fR\ \fIfile\fR] [\fB\-verbose\fR] [\fB\-size\fR\ \fIn\fR] [\fB\-scale\fR]\ \fIinput\&.sgf\fR  [\fIoutput\&.png\fR]
.HP \w'\fBgogui\-thumbnailer\fR\ 'u
\fBgogui\-thumbnailer\fR \fB\-help\fR
.HP \w'\fBgogui\-thumbnailer\fR\ 'u
\fBgogui\-thumbnailer\fR \fB\-version\fR
.SH "DESCRIPTION"
.PP
Create SGF thumbnails according to the
\m[blue]\fBThumbnail Managing Standard\fR\m[]\&\s-2\u[1]\d\s+2
from
\m[blue]\fBfreedesktop\&.org\fR\m[]\&\s-2\u[2]\d\s+2\&. This allows previewing the SGF files in file managers that support this standard, like
\m[blue]\fBNautilus\fR\m[]\&\s-2\u[3]\d\s+2\&. The installation script
install\&.sh
in the GoGui package will install this program as a thumbnailer for the
\m[blue]\fBGNOME\fR\m[]\&\s-2\u[4]\d\s+2
desktop environment\&.
.PP
The thumbnails will show the final position of the main variation, or the first position that contains both black and white setup stones\&. The rationale for this is that one usually wants to see the last position of a game, which may contain black handicap setup stones before the moves, but the thumbnail should not show the solution of files containing Go problems\&.
.PP
If the thumbnailer is invoked without output filename, the thumbnails will be created in the directory
\fB\&.thumbnails/normal\fR
in the user home directory\&.
.SH "OPTIONS"
.PP
\fB\-config\fR \fIfile\fR
.RS 4
Read command line options and arguments from the given file\&.
.RE
.PP
\fB\-help\fR
.RS 4
Display help and exit\&.
.RE
.PP
\fB\-scale\fR
.RS 4
Assume that the given image size is for 19x19 and use a corresponding fraction of the size for other board sizes\&.
.RE
.PP
\fB\-size\fR \fIn\fR
.RS 4
This option sets the maximum Thumbnail size\&. Default is 128\&.
.RE
.PP
\fB\-verbose\fR
.RS 4
Print logging messages to standard error\&.
.RE
.PP
\fB\-version\fR
.RS 4
Print version and exit\&.
.RE
.PP

.SH "NOTES"
.IP " 1." 4
Thumbnail Managing Standard
.RS 4
\%http://jens.triq.net/thumbnail-spec/index.html
.RE
.IP " 2." 4
freedesktop.org
.RS 4
\%http://freedesktop.org
.RE
.IP " 3." 4
Nautilus
.RS 4
\%http://www.gnome.org/projects/nautilus/
.RE
.IP " 4." 4
GNOME
.RS 4
\%http://www.gnome.org
.RE
